Overview

Update Django Version
The version being used by the lockfile is Django 4.2.27.
Django 4.2.x remains supported until April 2026.

Recommended target: Django 5.2.12 (latest 5.2 LTS patch).

PR Status

• Ready.
• Work in Progress.
• Hold.

Related Links

• WP-1196

Summary of Changes

pyproject.toml

Three dependency constraints changed:

1. Django:

• Before: >=4.2,<5.0.0
• After: exactly 5.2.12

2. django-filer:

• Before: >=2.2,<3.0
• After: >=3.0,<4.0
• Required because filer 2.x explicitly restricts Django to <5.

3. djangocms-text-ckeditor:

• Before: 5.1, which resolved to 5.1.0
• After: exactly 5.1.7
• Fixes its use of Django APIs removed in Django 5.

poetry.lock

The lockfile was regenerated with Poetry 2.1.3. Principal resolved changes:

1. Django 4.2.27 → 5.2.12
2. django-filer 2.2.8 → 3.5.0
3. djangocms-text-ckeditor 5.1.0 → 5.1.7
4. Added py-svg-hush 0.3.0, required by the newer filer
5. Removed filer dependencies no longer required:

• django-mptt
• django-js-asset

6. Updated package constraints, artifact hashes, and the lockfile content hash

common_settings.py

Added the compatibility helper import:
from designsafe.settings.djangocms_forms_compat import apply_storage_compatibility
Then, after the Django 5 STORAGES configuration:

DEFAULT_FILE_STORAGE = STORAGES["default"]["BACKEND"]
apply_storage_compatibility()

This lets the archived forms plugin obtain its legacy setting from the authoritative Django 5 storage configuration. It does not introduce a separate storage configuration.

djangocms_forms_compat.py

This is a new compatibility adapter for djangocms-forms-maintained:

from django.core.files import storage
from django.utils.module_loading import import_string

It conditionally restores the removed get_storage_class function:

if not hasattr(storage, "get_storage_class"):
    storage.get_storage_class = import_string

The conditional makes it safe if the code is ever run with an older Django version where get_storage_class still exists.
This adapter is necessary because djangocms-forms-maintained still:

• Reads the removed DEFAULT_FILE_STORAGE setting
• Imports the removed django.core.files.storage.get_storage_class
  It should be removed once that archived plugin is replaced with a Django 5-native forms package.

Testing Steps

1. …

UI

Notes